home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / wb-tools / win95 tools / o_s_b2 / o_s-b.doc < prev    next >
Text File  |  1996-04-14  |  7KB  |  159 lines
  1. $VER: oLIVERS_sTART-bUTTON dOCUMENTATION V2.02, (c)'96 by O.Tennie
  2.  
  3.                     *---------------------------------------*
  4.                    /  ___                ___  __  ,  ___   /
  5.                   /  /  /  /    /  | /  /_   /_/    /__   /
  6.                  /  /__/  /__  /   |/  /__  /\     ___/  /
  7.                 /         ___  ____  __   __  ____      /
  8.                /         /__    /   /_/  /_/   /       /
  9.               /         ___/   /   / /  /\    /       /
  10.              /     __       ____  ____   ___         /
  11.             /     /_/  / /   /     /    /  /  /| /  /
  12.            /     /_/  /_/   /     /    /__/  / |/  /
  13.           *---------------------------------------*
  14.  
  15.                           V 2.02r/s               
  16.  
  17.                   (c)'1996 by Oliver Tennie
  18.  
  19.                 +---------------------------+
  20.                 | This program is SHAREWARE |
  21.                 +---------------------------+
  22.  
  23. Disclaimer:
  24. -----------
  25. The author can not be held responsible for any damages caused by the
  26. program. You use this program at your own risk.
  27.  
  28. Copyright:
  29. ----------
  30. This program (including the documentation and the icons) is 
  31. copyright 1996 by Oliver Tennie. You are not allowed to change/modify
  32. anything or to use anything in your own programs without the written
  33. permission of the author.
  34.  
  35. Distribution:
  36. -------------
  37. The unregistered version may be distributed freely on any disc or cd-rom
  38. as long as the costs for the media does not exceed a "normal" price
  39. (normal means about the price of a Fish/AmiNet cd-rom/disc). This
  40. program may also be distributed on any network, except for the MSN.
  41. It is allowed to put the complete (!) package on the coverdisk of a mag.
  42.  
  43. Shareware:
  44. ----------
  45. This program is shareware. If you use it regulary, you are asked to
  46. send a small fee (see below) to the author. You will get a personalized
  47. version of the program without the limitation (in the unregistered version
  48. only the first 20 lines of the configuration-file are read).
  49.  
  50. To register, just send 15,-DM or 10,-US$ or 10,-UK£ to:
  51.  
  52.  Oliver Tennie
  53.  Efeuweg 9
  54.  22299 Hamburg
  55.  GERMANY
  56.  
  57. **Special offer: If you register until the 30/June/1996 the registration-fee
  58.                  is only 10,-DM (sorry, no discount on US$ or UK£).
  59.  
  60. Requirements:
  61. -------------
  62. In order to run, this program needs the following:
  63.     - Kickstart / Workbench 2.04 (or higher)
  64.     - ReqTools.library ( (c) Nico Francois)
  65.     - an assign to "t:"
  66.     - the command "c:execute"
  67.  
  68. Installation:
  69. -------------
  70. Simple. Just copy the program to your WBStartup-drawer and the
  71. configuration-file to your ENVARC: -assign. Afterwards you'll have
  72. to change the config-file (using a normal editor) in order to fit it
  73. to your needs. Then you should reboot your Amiga to use the program.
  74.  
  75. Included in this archive are two versions of the program. One is called
  76. "o_s-b2_01s" and the other one is called "o_s-b2_01s-nolib". If you have
  77. "AMOS.library" (Version >= 2.0) installed in your LIBS:-drawer, you may
  78. use the "-nolib"-version (it will save some bytes on your hd), if you 
  79. don't have "AMOS.library" you'll have to use the bigger version.
  80.  
  81. The configuration-file:
  82. -----------------------
  83. The usage of the configuration-file is to tell o_s-b which programs
  84. can be loaded and how.
  85. You can define groups, program-titles, the program-path and the 
  86. cli/shell-command to load the program. o_s-b reads through the
  87. configuration-file from top to bottom and so programs will always be
  88. added to the last defined group. 
  89.   !! It is not allowed to add programs without defining a group !!
  90.   !! before, so you'll always have to create at least one group !!
  91.  
  92. A valid line starts with one of the following commands (all other lines
  93. are ignored and can be used for comments):
  94.  
  95.  ":"  - this shows o_s-b that a new group should be defined
  96.  ">"  - this tells o_s-b the name of the new program
  97.  "!"  - this is the cli/shell-command that will launch the program
  98.         (note: this command always refers to the last given name)
  99.  "#"  - this tells o_s-b in which directory it should change
  100.         (note: this command always refers to the last given name)
  101.  
  102. Following to the command is the parameter, for example the name of the
  103. new group or the program-name.
  104.  
  105. To get an idea how the configuration-file works, just have a look at the
  106. example in this distribution. 
  107.  
  108. Since version 2.02 you can also tell o_s-b the Workbench-Screen-hight.
  109. This is useful if you have a WB-resolution different to 640*256 because
  110. in this case o_s-b (up to version 2.01) did either not start or it 
  111. displayed the button somewhere in the middle of the screen. To tell
  112. o_s-b the height of your WB-Screen you'll have to insert the following
  113. command before all other commands (!) in the prefs-file:
  114.      ScreenHight=xyz
  115. where xyz is the number of vertical lines of your screen (the default
  116. is 256 (for HiRes-PAL-Screens)). This command is NOT case-sensitive.
  117.  
  118. Usage:
  119. ------
  120. After you installed the program properly (see Installation) and after
  121. you rebooted your Amiga, you shold see a small "Start"-button at the
  122. left bottom of your screen. If you click on it once, a bigger window will
  123. appear with two lists in it. The list on the left side shows you all
  124. the groups you defined in the config-file and the list on the right side
  125. shows you all programs for the current group. At the bottom of the
  126. left list, you will also see the entries "About" (which will display
  127. some informations), "Close" (which will close the big window) and 
  128. "Quit" (which will exit the program). To change the current group, just
  129. click on an entry from the left list, the right list will change and you
  130. can load a program from it by clicking it once.
  131.  
  132. Some informations:
  133. ------------------
  134. This program was written using:
  135.    - AmosPRO & AmosPro-Compiler, both (c) Europress Software Ltd.
  136.    - AMIPS V1.04, (c) by The Software Society
  137.  
  138. This program uses:
  139.    - ReqTools.Library, (c) by Nico Francois
  140.  
  141. History:
  142. --------
  143. V1.00 - * initial version
  144.  
  145. V2.00 - * complete rework of the program
  146.  
  147.         * name changed from TaskBar to oLIVER'S_sTART-bUTTON because
  148.           the name TaskBar was already used from another author for
  149.           his program
  150.  
  151.         * directory-changes are now possible
  152.  
  153. V2.01 - * on program-startup the window is no longer activated
  154.           (nasty "bug", because WorkBench was therefore inactive
  155.            on startup, when o_s-b was placed in WBStartup)
  156.  
  157. V2.02 - * o_s-b will now work properly on Workbench-screens with
  158.           resolutions different to 640*256
  159.